在網路的世界裡傳遞資訊時所使用的資料格式有很多種,像是 JSON, XML, CSV files...等等。而本次 API 會用到的資料格式為 JSON。
全名為 JavaScript Object Notation,是一種類似 JavaScript object 的文字資料格式,由於其可讀性高、易編寫、易解析與產生的特性,現在被廣泛應用於網頁開發領域中。
跟 JavaScript 的物件是完全不同的東西哦!
一個簡單的 JSON 語法範例如下:
{
"name": "John Doe",
"age": 30,
"isStudent": false,
"hobbies": ["reading", "swimming"]
}
JSON 的結構是由 key-value 組成,value 可為字串、數字、布林值、陣列或是另一個 JSON 等,看起來很像 python dictionary,對吧?
不過實際上 JSON 檔案無法直接被程式語言使用,在客戶端傳給伺服器 JSON 資料時必須先進行去序列化(deserialize),將 JSON 資料轉換成程式語言的資料型態後才能進行後續處理;相反的,當伺服器端要傳送資料給客戶端時同樣也需要將程式語言資料序列化(serialize),才能夠被網路傳送,而客戶端也能夠同樣用去序列化的方式處理資料。運用部分的實作會在後續進行。
了解了 JSON 的基礎後,接下來會先做 User model,再來是使用 Swagger 產生介面並嘗試操作。我們明天見~